home *** CD-ROM | disk | FTP | other *** search
/ JCSM Shareware Collection 1993 November / JCSM Shareware Collection - 1993-11.iso / cl040 / scrwtchj.lzh / SCRWATCH.DOC < prev    next >
Encoding:
Text File  |  1992-10-30  |  5.8 KB  |  140 lines
  1.  
  2. ==============================================================================
  3.                 <-------  Screen Watch Program Ver 1.1  -------->
  4.  
  5. Written by:
  6.  
  7. Gerry Freymann                              This program is released into the
  8. Sysop, The Phantom BBS                      Public Domain for all to hack,
  9. P.O. Box 1226                               alter, scab, delete or use.
  10. Cobourg, Ontario
  11. K9A 5A4                                     Send no money, this program is
  12.                                             absolutely free.  If you paid for
  13. Data:  (416) 342-3734 USR Dual              it you got ripped off!  Tsk Tsk.
  14.        (416) 342-3766 USR HST
  15.  
  16.     The latest versions/updates are available on The Phantom BBS and
  17.  
  18.                               TDS Network
  19.                    The PC ToyShop Information System
  20.                          24 Hours, 300 -> 38.4K
  21.                              (503) 342-4447
  22.                              Eugene, Oregon
  23. ==============================================================================
  24.  
  25. Screen Watch V1.1 - What's it all about anyway?
  26. ===============================================
  27.  
  28. The concept behind this program is very simple.  I have a large stock of
  29. Welcome screens that I use throughout the year.  These screens are for special
  30. days like Christmas, New Years, Easter, St. Patricks Day, the first official
  31. day of summer and fall, and days like that.
  32.  
  33. What I wanted was a program that would automatically replace my existing
  34. Welcome screens on the days required, PLUS, copy the original screens back
  35. when the "special" screen was no longer needed.  Screen Watch is the result
  36. of this idea, and took one hour to write, compile, test and write the docs.
  37.  
  38. This program is released into the Public Domain.  Full QuickBasic source code
  39. can be aquired by asking, but since it is linked to Advbas I didn't see the
  40. need to include the full basic code as well.
  41.  
  42. V1.1 adds full colour exploding/scrolling/shadowed windows and fixes the
  43. DIM statement.. I had it backwards for heaven's sake in v1.0 - this 1.1
  44. release will correctly store information for every day of the year! Thanks
  45. to Dana Laude for alerting me to this mistake.
  46.  
  47.  
  48. Basic program Operation
  49. =======================
  50.  
  51. When activated (it only takes seconds to do the job!) the program scans your
  52. .CFG file to find a matching date.  It does this twice, one glance through
  53. the START DATE and once through the STOP DATE.  Why two?  This allows you to
  54. have a screen up for any period of time, be that one day, a week or a month!
  55. Based on the info supplied in your .CFG file your screens will automatically
  56. be copied on the days you specified, and returned to normal when you say so.
  57. The dates you supply will depend on when you run your event.  I run mine
  58. during the overnight, so if I want a screen up for St. Patrick's Day, which is
  59. March 17th, then I put 03-17 in the .CFG file as the start date, and 03-18 in
  60. the .CFG file as the stop date.
  61.  
  62. You could also use this for your NEWS screens, or any other standard type
  63. of screen you use on your system.
  64.  
  65. And of course, this can be used with ANY BBS program, it is not specific to
  66. PCBoard.
  67.  
  68. When you call up SCRWATCH you can specify a .CFG file after the program's name
  69. or leave the space blank, and it will read [SCRWATCH.CFG] by default.
  70.  
  71. Designing your .CFG file
  72. ========================
  73. You can have up to 366 lines.  If you go past that (which I doubt anyone would
  74. ever do.  At one screen per day that is 365) the data will be ignored.  Each
  75. line consists of FOUR pieces of information.
  76.  
  77. The FIRST line is a special line!
  78.  
  79.  First:  Your everyday standard ASCII screen
  80. Second:  Your everyday standard ANSI screen
  81.  Third:  Your ASCII Welcome screen as defined in PCBSetup
  82. Fourth:  Your ANSI Welcome screen.
  83.  
  84.  
  85. The REMAINING lines are as follows!
  86.  
  87.  First:  The date to put up the new screen in MM-DD format
  88. Second:  The ASCII screen name
  89.  Third:  The ANSI screen name
  90. Fourth:  The date to put back the standard ASCII/ANSI screens in MM-DD format
  91.  
  92.  
  93.  
  94. All data must be surrounded by quotes and separated by a comma.  Don't quite
  95. follow all of this stuff yet?  Here's a sample .CFG file to inspect.
  96.  
  97. "WELCOME1.ASC","WELCOME1.ANS","WELCOME","WELCOMEG"   'Line 1
  98. "03-17","STPATTY.ASC","STPATTY.ANS","03-18"          'Line 2
  99. "03-26","EASTER.ASC","EASTER.ANS","03-27"            'Line 3
  100.  
  101. On March 17th the program will take STPATTY.ASC and copy it to WELCOME,
  102.                                 and STPATTY.ANS will be copied as WELCOMEG.
  103.  
  104. Then on March 18th the program will take WELCOME1.ASC and copy to WELCOME
  105.                                      and WELCOME1.ANS and copy to WELCOMEG
  106.  
  107. On March 26th the program will take EASTER.ASC and copy it to WELCOME,
  108.                                 and EASTER.ANS will be copied as WELCOMEG.
  109.  
  110. Then on March 27th the program will take WELCOME1.ASC and copy to WELCOME
  111.                                      and WELCOME1.ANS and copy to WELCOMEG
  112.  
  113. As you can see, you can have a screen on-line as long as you want.
  114.  
  115.  
  116.  
  117. Conclusion:
  118. ===========
  119.  
  120. In this fun world of being a Sysop, utilities like this make things go like
  121. clock_work so you can spend more time trying to understand someone else's
  122. documentation that like this, appeared very strange and awkward but in fact
  123. turned out to be not half bad!
  124.  
  125. Why are these docs formatted as they are?  Why, if you are like me and use
  126. LIST all the time to read docs, you'll notice each "page" is formatted for
  127. one screen.  If you used Pg Dn to view this, the screens lined up perfectly!
  128.  
  129. What a nice touch eh?  Sorry, it's Sunday and it's getting late.
  130.  
  131. I hope you enjoy this handy dandy utility as much as I am going to.  Read
  132. over FLYER.DOC for a list of other programs I have available for PCBoard
  133. Sysops (is there anything else but?).
  134.  
  135. Gerry Freymann
  136. March 5, 1989/Updated to v1.1 Dec 9, 1989.
  137. 
  138.  
  139.  
  140.